package org.example.projecttwo.mapper;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import org.example.projecttwo.entity.Collection;
import org.example.projecttwo.entity.dto.content.response.CollectionVO;
import org.apache.ibatis.annotations.Param;

/**
 * <p>
 * 收藏表 Mapper 接口
 * </p>
 *
 * @author nn
 * @since 2025-11-01
 */
public interface CollectionMapper extends BaseMapper<Collection> {

    /**
     * 分页查询用户收藏，关联内容信息
     * @param page 分页参数
     * @param userId 用户ID
     * @param contentType 内容类型
     * @param keyword 搜索关键词
     * @return 分页的收藏视图对象
     */
    IPage<CollectionVO> selectPageByUserWithSearch(
            Page<CollectionVO> page,
            @Param("userId") Long userId,
            @Param("contentType") Integer contentType,
            @Param("keyword") String keyword);

    /**
     * 根据收藏ID查询详情（关联内容信息）
     * @param id 收藏ID
     * @return 收藏视图对象
     */
    CollectionVO selectDetailById(@Param("id") Long id);

    /**
     * 根据用户和内容信息删除收藏
     * @param userId 用户ID
     * @param contentType 内容类型
     * @param contentId 内容ID
     * @return 影响行数
     */
    int deleteByUserContent(
            @Param("userId") Long userId,
            @Param("contentType") Integer contentType,
            @Param("contentId") Long contentId);

    /**
     * 统计用户对指定内容的收藏数量
     * @param userId 用户ID
     * @param contentType 内容类型
     * @param contentId 内容ID
     * @return 收藏数量
     */
    Integer countByUserContent(
            @Param("userId") Long userId,
            @Param("contentType") Integer contentType,
            @Param("contentId") Long contentId);

    /**
     * 统计指定内容的总收藏数量
     * @param contentType 内容类型
     * @param contentId 内容ID
     * @return 收藏数量
     */
    int countByContent(
            @Param("contentType") Integer contentType,
            @Param("contentId") Long contentId);
}